The Sitecore Plus package is distributed as a standard Sitecore package; hence in order to start using it, you should install the package. Please, refer to the Installing Modules and Packages article if you are not familiar with the Sitecore standard Packager tool.
Add the following settings into web.config:
- Add xml control into the <controlSources> section of the web.config
<source mode="on" namespace="Sitecore.Web.UI.XmlControls" folder="/sitecore modules/shell/Plus/" deep="true"/>
<source mode="on" namespace="Sitecore.Plus.Portlets" assembly="Sitecore.Plus"/> - Add reference to Sitecore.Plus.dll into the <references> section of the web.config.
<reference>/bin/Sitecore.Plus.dll</reference> - Add http request begin handler into the <httpRequestBegin> section. This line should be added after the Sitecore.Pipelines.HttpRequest.ItemResolver processor and placed right below it.
<processor type="Sitecore.Modules.SSLRedirector.Pipelines.Resolver, Sitecore.Plus" /> - Add handler to the item:deleting event
<event name="item:deleting" >
...
<handler type="Sitecore.Plus.Portlets.MyLockedItems.ItemHandlers, Sitecore.Plus" method="OnItemDeleting"/>
...
</event> - Add handler to the item:saved section
<event name="item:saved">
...
<handler type="Sitecore.Plus.Portlets.MyLockedItems.ItemHandlers, Sitecore.Plus " method="OnItemSaved"/>
...
</event> - Add commands in file App_Config/Commands.config file into <configuration> section
<command name="item:undoedit" type="Sitecore.Shell.Commands.UndoEdit,Sitecore.Plus" />
<command name="bugreport:show" type="Sitecore.Plus.BugReport.MessageHandle, Sitecore.Plus"/>
My Locked Items portlet note:
If you do not intend to use the My Locked Items portlet, you may skip steps 4-5 above to ensure maximum Sitecore performance.
1. Upgrade Instructions
Upgrading from Plus package v1.0.2 to v1.0.3
- Install the new package.
Note: When you install the package there will be items and files to be installed that already exist.
You should choose to overwrite files
You should choose Merge and the sub option Merge for items.
- You should comment out the following handlers from web.config before installing the package so they look like the following example:
<event name="item:saved">
………………….
<!--- Commented this line out for Plus package v1.0.3 for Sitecore CMS v5.3.1
<handler type="Sitecore.Plus.Portlets.MyLockedItems.ItemHandlers, Sitecore.Plus " method="OnItemSaved"/>
--->
………………….
</event>
<event name="item:deleting">
<!--- Commented this line out for Plus package v1.0.3 for Sitecore CMS v5.3.1
<handler type="Sitecore.Plus.Portlets.MyLockedItems.ItemHandlers, Sitecore.Plus" method="OnItemDeleting"/>
--->
</event>
Upgrading from Plus package v1.0.0/1.0.1 to v1.0.2
Before installing the Plus package, disable all settings in the web.config and commands.config files related to the Plus module.
Install the Plus package with the Overwrite option.
Enable settings in web.config and commands.config and make the following changes in web.config:
- The handler in the item:deleting section:
<handler type="Sitecore.Plus.Portlets.Handlers, Sitecore.Plus" method="OnItemDeleting"/>
should be changed to:
<handler type="Sitecore.Plus.Portlets.MyLockedItems.ItemHandlers, Sitecore.Plus" method="OnItemDeleting"/> - The handler in the item:saved section:
<handler type="Sitecore.Plus.Portlets.Handlers, Sitecore.Plus " method="OnItemAdded"/>
should be changed to:
<handler type="Sitecore.Plus.Portlets.MyLockedItems.ItemHandlers, Sitecore.Plus " method="OnItemSaved"/> - Processor should be removed from the <pipelines>/<initialize> section:
<processor type="Sitecore.Plus.Portlets.InitializeMyLockedItem, Sitecore.Plus"/>